home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / mailbox.z / mailbox
Text File  |  1998-10-20  |  13KB  |  265 lines
  1.  
  2.  
  3.  
  4. mmmmaaaaiiiillllbbbbooooxxxx((((1111))))                                                          mmmmaaaaiiiillllbbbbooooxxxx((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mailbox - mail notification
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      mmmmaaaaiiiillllbbbbooooxxxx [ ----ccccllllbbbbdddd ] [ ----uuuu user ] [ ----ssss size ] [ ----LLLL latitude ]
  13.           [ ----MMMM longitude ] [ ----SSSS label ] [ ----mmmm mail-program ] [ ----ffff mail-file ]
  14.           [ ----CCCC envelope-counter ] [ ----BBBB beeper ] [ ----DDDD directory ] [ ----gggg XxY ] [ ----NNNN window name ]
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _m_a_i_l_b_o_x watches your mailbox, and notifies you when you have mail.  It
  18.      displays a small picture of a mailbox to perform notification.  The flag
  19.      on the mailbox rises whenever new mail messages appear in your mailbox.
  20.  
  21.      You can open the mailbox and read your mail by clicking on the _m_a_i_l_b_o_x
  22.      window with the left mouse button.  If one of the shift keys is held
  23.      down, or if you have no mail, the mailbox door simply opens without
  24.      running the mail reading program.  Once you have finished reading your
  25.      mail, the mailbox flag goes down and the door closes.
  26.  
  27.      The number of envelopes in the mailbox corresponds to the number of
  28.      messages in your mailbox.  Manila envelopes represent five messages each.
  29.      Each normal letter-sized envelope represent one message.  _m_a_i_l_b_o_x knows
  30.      how to count messages written by Berkeley and AT&T _m_a_i_l, and by _m_h.
  31.      _m_a_i_l_b_o_x also understands Content-Length headers.
  32.  
  33.      The MAIL environment variable is used to determine where to watch for
  34.      mail.  If this variable does not exist, the USER environment variable is
  35.      appended to the string "/usr/mail", and this file is used.
  36.  
  37. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  38.      ----cccc    Run in colormap mode.  Ordinarily, the decision to display in
  39.            colormap mode is made on the basis of available graphics hardware.
  40.  
  41.      ----llll    Run in lighted, RGB mode.  This is currently a no-op.
  42.  
  43.      ----bbbb    Don't beep when mail arrives.
  44.  
  45.      ----dddd    Print out longitude and latitude on startup.
  46.  
  47.      ----uuuu _u_s_e_r
  48.            Watch the mail of a user other than yourself.
  49.  
  50.      ----mmmm _m_a_i_l__p_r_o_g_r_a_m
  51.            Execute the specified program when requested to.  The argument
  52.            following the option must be a single string.  This is generally
  53.            accomplished by putting double quotes around the string.  If an
  54.            empty string is passed, _m_a_i_l_b_o_x simply opens and closes the mailbox
  55.            door when the window is clicked on.
  56.  
  57.            The program string is executed by _s_y_s_t_e_m(3S), so environment
  58.            variables and other shell substitutions can be used in this string.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmaaaaiiiillllbbbbooooxxxx((((1111))))                                                          mmmmaaaaiiiillllbbbbooooxxxx((((1111))))
  71.  
  72.  
  73.  
  74.            Note that the program that is started by _m_a_i_l_b_o_x probably should
  75.            not be a program that reads from standard input and output, since
  76.            it tries to run in the shell window that started it.  If such a
  77.            behavior is desired, the ----mmmm option starts a _w_s_h(1G) window to
  78.            contain the program.  The default ----mmmm command used by _m_a_i_l_b_o_x is
  79.  
  80.  
  81.                 _////_uuuu_ssss_rrrr_////_ssss_bbbb_iiii_nnnn_////_xxxx_wwww_ssss_hhhh _----_ffff_gggg _7777 _----_bbbb_gggg _9999_7777 _----_bbbb_oooo_llll_dddd _2222_3333_0000 _----_cccc_uuuu_rrrr_ssss_oooo_rrrr_ffff_gggg _9999_5555 _\\\\
  82.                 _----_gggg_eeee_oooo_mmmm _8888_0000_xxxx_4444_0000 _----_nnnn_aaaa_mmmm_eeee _MMMM_aaaa_iiii_llll _----_hhhh_oooo_llll_dddd_oooo_nnnn_eeee_rrrr_rrrr_oooo_rrrr _----_eeee _////_uuuu_ssss_rrrr_////_ssss_bbbb_iiii_nnnn_////_MMMM_aaaa_iiii_llll
  83.  
  84.            The environment variable MMMMAAAAIIIILLLLBBBBOOOOXXXXPPPPRRRROOOOGGGG can be set to specify a mail
  85.            program in the same manner as specifying the ----mmmm switch. If the
  86.            environment variable is set and the ----mmmm switch is not specified, the
  87.            environment variable determines the mail program.  If the
  88.            environment variable is set and the ----mmmm switch is also specified,
  89.            the command line mail program overrides the setting of the
  90.            environment variable.
  91.  
  92.  
  93.  
  94.      ----ssss _s_i_z_e
  95.            Set the size of the window, in points.  The default size is 96
  96.            points, or 1.33 inches.  The _m_a_i_l_b_o_x window is always square.
  97.  
  98.      ----gggg _p_o_s_i_t_i_o_n
  99.            Set the position of the window in pixels.  The position has the
  100.            following form:  <X>x<Y> or <X>X<Y> where <X> is the X position in
  101.            pixels and <Y> is the Y position in pixels for the lower left
  102.            corner of the window. The origin is the lower left corner of
  103.            screen.
  104.  
  105.      ----LLLL _l_a_t_i_t_u_d_e
  106.            Specify the latitude where the mailbox is located.  This is used to
  107.            determine the direction of the sun, and the times of sunset and
  108.            sunrise.  Latitudes south of the equator are specified as a
  109.            negative number.  If no latitude is specified, 37 degrees 30' N is
  110.            assumed.  The latitude can also be specified through the
  111.            environment variable LATITUDE, which overrides the default
  112.            latitude, but is overridden by command-line options.
  113.  
  114.      ----MMMM _l_o_n_g_i_t_u_d_e
  115.            Specify the longitude where the mailbox is located.  This is used
  116.            to determine the direction of the sun, and the times of sunset and
  117.            sunrise.  The default longitude is 122 degrees west.  Longitudes
  118.            are expressed as degrees west of Greenwich, England.  Longitudes
  119.            east of Greenwich are specified as negative numbers.  The longitude
  120.            can also be specified through the environment variable LONGITUDE,
  121.            which operates in the same way as LATITUDE.
  122.  
  123.      ----SSSS _l_a_b_e_l
  124.            Put a small sign on top of the mailbox with the specified label
  125.            printed on it.  Unfortunately, the sign is hard to read if the
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. mmmmaaaaiiiillllbbbbooooxxxx((((1111))))                                                          mmmmaaaaiiiillllbbbbooooxxxx((((1111))))
  137.  
  138.  
  139.  
  140.            window is small, due to resolution limits.  If this bothers you,
  141.            make the mailbox bigger with the ----ssss option.
  142.  
  143.      ----NNNN _w_i_n_d_o_w _n_a_m_e
  144.            The window name is any string to be given the program as the name
  145.            or title.  X resources can then be specified for <name> and refer
  146.            to this window.
  147.  
  148.      ----ffff _f_i_l_e
  149.            Specify that _m_a_i_l_b_o_x watch a file other than your system mailbox,
  150.            as though it were a mailbox.  Note that _m_a_i_l_b_o_x only puts up the
  151.            flag if it determines that actual mail messages have been added to
  152.            the file, by counting the number of messages.  However, the ----CCCC
  153.            option can be used to change the way that _m_a_i_l_b_o_x counts messages.
  154.  
  155.      ----CCCC _e_n_v_e_l_o_p_e-_c_o_u_n_t_e_r
  156.            _m_a_i_l_b_o_x usually counts the number of envelopes in your mailbox
  157.            every time that it notices that the mailbox has been touched.  If
  158.            the number of envelopes is greater than the last time it checked,
  159.            it raises the flag.  However, you can change _m_a_i_l_b_o_x's concept of
  160.            how to count envelopes by specifying an "envelope-counting"
  161.            program.
  162.  
  163.            The name of the mail file being watched is appended to the
  164.            specified string, and the result is passed to _s_y_s_t_e_m(3S).  The job
  165.            of the counting program is to call _e_x_i_t(2) with an argument that is
  166.            equal to the number of envelopes.  If the counting program exits
  167.            with a negative status, or if it is stopped by a signal, the number
  168.            of envelopes is assumed to be zero.  Because exit status is modulo
  169.            256, this is really only useful for mailboxes with less than 256
  170.            messages.
  171.  
  172.            This option can be used to turn _m_a_i_l_b_o_x into a more general file-
  173.            watching program, in conjunction with the ----ffff and ----mmmm options.
  174.  
  175.      ----BBBB _b_e_e_p_e_r
  176.            _m_a_i_l_b_o_x usually beeps whenever it determines that new mail has
  177.            arrived.  You can override this action by providing a "beeper"
  178.            program.  Typical beeping programs might send data to /_d_e_v/_a_u_d_i_o.
  179.            The beeping program is a string that is passed to _s_y_s_t_e_m(3S).
  180.  
  181.      ----DDDD _d_i_r_e_c_t_o_r_y
  182.            This option tells _m_a_i_l_b_o_x to watch the named directory instead of a
  183.            file.  When in this mode, _m_a_i_l_b_o_x assumes that each file in the
  184.            directory (except files whose names start with '.') is a mail
  185.            message.  This mode is useful for users of the _m_h and _x_m_h(1) mail
  186.            handling programs who choose to have messages delivered directly
  187.            into folders using the features of _s_l_o_c_a_l.  For example the
  188.            following command tells _m_a_i_l_b_o_x to watch the _m_h folder called _i_n_b_o_x
  189.            and to use _x_m_h as the mail reader.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. mmmmaaaaiiiillllbbbbooooxxxx((((1111))))                                                          mmmmaaaaiiiillllbbbbooooxxxx((((1111))))
  203.  
  204.  
  205.  
  206.  
  207.                 _mmmm_aaaa_iiii_llll_bbbb_oooo_xxxx _----_DDDD _~~~~_////_MMMM_aaaa_iiii_llll_////_iiii_nnnn_bbbb_oooo_xxxx _----_SSSS _iiii_nnnn_bbbb_oooo_xxxx _----_mmmm _""""_xxxx_mmmm_hhhh _----_iiii_nnnn_iiii_tttt_iiii_aaaa_llll _iiii_nnnn_bbbb_oooo_xxxx_""""
  208.  
  209.            The arguments to _x_m_h tell it to start with _i_n_b_o_x as its initial
  210.            folder.  This is its default.  The arguments are included here for
  211.            illustration only.
  212.  
  213.            When _x_m_h starts it reads each message in the folder in order to
  214.            look at its subject line.  This fools _m_a_i_l_b_o_x into thinking you
  215.            have read the message, and thus the flag can be lowered
  216.            prematurely.
  217.  
  218. FFFFIIIILLLLEEEESSSS
  219.      /usr/sbin/Mail     Default mail program if the ----mmmm switch is not specified
  220.                         and $$$$MMMMAAAAIIIILLLLBBBBOOOOXXXXPPPPRRRROOOOGGGG is not set.
  221.      $MAILBOXPROG       Default mail program if the ----mmmm switch is not
  222.                         specified.
  223.      /usr/mail/$USER    Default mail file if the ----ffff switch is not specified
  224.                         and $$$$MMMMAAAAIIIILLLL is not set.
  225.      $MAIL              Default mail file if the ----ffff switch is not specified.
  226. AAAAUUUUTTTTHHHHOOOORRRR
  227.      Andrew Myers
  228. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  229.      chkconfig(1M), mail_att(1), mail_bsd(1), su(1M).
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.